home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / manageme / tcpdump-.001 / tcpdump-~ / tcpdump-3.0.2-linux / libpcap-0.0.6 / README < prev    next >
Encoding:
Text File  |  1995-04-28  |  2.9 KB  |  62 lines
  1. @(#) $Header: README,v 1.7+ 94/06/20 18:56:55 leres Exp $ (LBL)
  2.  
  3. LIBPCAP 0.0.6
  4. Lawrence Berkeley Laboratory
  5. Network Research Group
  6. libpcap@ee.lbl.gov
  7. ftp://ftp.ee.lbl.gov/libpcap-*.tar.Z
  8.  
  9. This directory contains source code for libpcap, a system-independent
  10. interface for user-level packet capture.  libpcap provides a portable
  11. framework for low-level network monitoring.  Applications include
  12. network statistics collection, security monitoring, network debugging,
  13. etc.  Since almost every system vendor provides a different interface
  14. for packet capture, and since we've developed several tools that require
  15. these interfaces, we've created this system-independent API to ease in
  16. porting and to alleviate the need for several system-dependent packet
  17. capture modules in each application.
  18.  
  19. THIS IS AN ALPHA-QUALITY RELEASE.  The interface is brand new and is
  20. likely to change.  If you code to this interface, and want to track
  21. future versions, be prepared to update your code.  We admit that this
  22. release is premature, but we're releasing it anyway because the tcpdump-3.0
  23. distribution requires it.
  24.  
  25. libpcap has been built and tested under SGI Irix 4.x & 5.2, SunOS 4.x,
  26. Solaris 2.3, BSD/386 v1.1, DEC/OSF v1.3 v2.0, and Ultrix 4.x.  SunOS 3.5
  27. 4.3BSD Reno/Tahoe and 4.4BSD are supported as well, but we currently
  28. do not have the resources to carry out testing in these environments
  29. (we suspect you'll run into problems under these systems -- please
  30. send us the patches if you fix any porting problems).
  31.  
  32. The libpcap interface supports a filtering mechanism based on the
  33. architecture in the BSD packet filter.  BPF is described in the
  34. 1993 Winter Usenix paper ``The BSD Packet Filter: A New Architecture
  35. for User-level Packet Capture''.  A compressed postscript version is in
  36.  
  37.     ftp://ftp.ee.lbl.gov/papers/bpf-usenix93.ps.Z.
  38.  
  39. Although most packet capture interfaces support in-kernel filtering,
  40. libpcap utilizes in-kernel filtering only for the BPF interface.
  41. On systems that don't have BPF, all packets are read into user-space
  42. and the BPF filters are evaluated in the libpcap library, incurring
  43. added overhead (especially, for selective filters).  We haven't tried
  44. taking advantage of other packet filter models first because they
  45. aren't general enough (i.e., only simple filters can be evaluated),
  46. and second because we don't have the time to modify the code generator
  47. (or write a filter translator) and BPF is more efficient anyway.
  48.  
  49. BPF is standard in 4.4BSD, BSD/386, NetBSD, and FreeBSD.  DEC OSF/1
  50. uses the packetfilter interface but has been extended to accept
  51. BPF filters (which libpcap utilizes).  Also, you can add BPF filter
  52. support to Ultrix using the kernel source and/or object patches
  53. available in
  54.  
  55.      ftp://gatekeeper.dec.com/pub/DEC/net/bpfext42.tar.Z.
  56.  
  57. Please send bugs and comments to libpcap@ee.lbl.gov.
  58.  
  59.  - Steve McCanne (mccanne@ee.lbl.gov)
  60.    Craig Leres (leres@ee.lbl.gov)
  61.    Van Jacobson (van@ee.lbl.gov)
  62.